# 导入 pytest 测试框架核心模块
# pytest 是 Python 常用的单元测试/自动化测试框架，用于组织测试用例、执行测试并生成报告
import pytest

# 主程序入口：判断当前脚本是否被直接运行（而非被其他脚本导入）
# __name__ 是 Python 内置变量，当脚本直接运行时，__name__ 会被赋值为 "__main__"
if __name__ == '__main__':
    # 调用 pytest 框架的 main() 方法，执行指定的测试任务
    # main() 方法接收一个列表参数，每个元素对应一条 pytest 执行指令
    pytest.main([
        '../jiuxian_html/test_jiuxianwang.py',  # 1. 指定要执行的测试用例文件路径
        # 路径说明："../" 表示当前脚本所在目录的【上一级目录】，"jiuxian_html" 是存放测试用例的文件夹，
        # "test_jiuxianwang.py" 是具体的测试用例文件（包含你写的 test_jiuxian01、test_A3mall02 等用例）
        '-s',  # 2. 启用控制台输出功能（关键参数）
        # 作用：禁用 pytest 默认的「输出捕获」机制，让测试用例中 print() 打印的内容（如商品价格、元素状态）
        # 能直接显示在控制台，方便调试和查看测试过程
        '--html=baogao.html'  # 3. 生成 HTML 格式的测试报告
        # 作用：通过 pytest-html 插件（需提前安装）生成可视化的 HTML 报告，
        # "baogao.html" 是报告文件名，默认保存在当前脚本运行的目录下，
        # 打开该文件可查看用例执行结果（通过/失败数、执行时间、错误日志等）
    ])